Clarify the docs of the color-set and font-set signals. (#343438, Olexiy

2006-05-31  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkfontbutton.c:
	* gtk/gtkcolorbutton.c: Clarify the docs of the color-set and
	font-set signals.  (#343438, Olexiy Avramchenko)

diff --git a/ChangeLog b/ChangeLog
index 57190bed72796395a810273dbb5949b9aee18bbf..ed88625a9e3ecbf23c124bebcc9dd88ee16ebc0b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-05-31  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkfontbutton.c: 
+       * gtk/gtkcolorbutton.c: Clarify the docs of the color-set and
+       font-set signals.  (#343438, Olexiy Avramchenko)
+
 2006-05-30  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkmain.c (gtk_grab_notify_foreach): Don't skip internal

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 57190bed72796395a810273dbb5949b9aee18bbf..ed88625a9e3ecbf23c124bebcc9dd88ee16ebc0b 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,9 @@
+2006-05-31  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkfontbutton.c: 
+       * gtk/gtkcolorbutton.c: Clarify the docs of the color-set and
+       font-set signals.  (#343438, Olexiy Avramchenko)
+
 2006-05-30  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkmain.c (gtk_grab_notify_foreach): Don't skip internal

diff --git a/gtk/gtkcolorbutton.c b/gtk/gtkcolorbutton.c
index a917cd22f56524426deb0a541a8d6c77ff76b03a..590e093dd53b46aa01963cc4851cfaa006b1a17f 100644 (file)
--- a/gtk/gtkcolorbutton.c
+++ b/gtk/gtkcolorbutton.c
@@ -223,9 +223,13 @@ gtk_color_button_class_init (GtkColorButtonClass *klass)
    * GtkColorButton::color-set:
    * @widget: the object which received the signal.
    * 
-   * The ::color-set signal is emitted when the user selects a color. When handling this signal,
-   * use gtk_color_button_get_color() and gtk_color_button_get_alpha() to find out which color 
-   * was just selected.
+   * The ::color-set signal is emitted when the user selects a color. 
+   * When handling this signal, use gtk_color_button_get_color() and 
+   * gtk_color_button_get_alpha() to find out which color was just selected.
+   *
+   * Note that this signal is only emitted when the <emphasis>user</emphasis>
+   * changes the color. If you need to react to programmatic color changes
+   * as well, use the notify::color signal.
    *
    * Since: 2.4
    */
@@ -237,7 +241,7 @@ gtk_color_button_class_init (GtkColorButtonClass *klass)
                                                  _gtk_marshal_VOID__VOID,
                                                  G_TYPE_NONE, 0);
 
-  g_type_class_add_private (gobject_class, sizeof (GtkColorButtonPrivate));
+  g_type_class_add_private (gobject_class, sizeof (GtkColorButtonPrivat;
 }
 
 static void

diff --git a/gtk/gtkfontbutton.c b/gtk/gtkfontbutton.c
index 2f1814434f05aeb828458adcd4aa4aff1085ad23..f6b6de3c779d0c57c9ec225c593ef181955cd4f8 100644 (file)
--- a/gtk/gtkfontbutton.c
+++ b/gtk/gtkfontbutton.c
@@ -231,9 +231,13 @@ gtk_font_button_class_init (GtkFontButtonClass *klass)
    * GtkFontButton::font-set:
    * @widget: the object which received the signal.
    * 
-   * The ::font-set signal is emitted when the user selects a font. When 
-   * handling this signal, use gtk_font_button_get_font_name() to find out
-   * which font was just selected.
+   * The ::font-set signal is emitted when the user selects a font. 
+   * When handling this signal, use gtk_font_button_get_font_name() 
+   * to find out which font was just selected.
+   *
+   * Note that this signal is only emitted when the <emphasis>user</emphasis>
+   * changes the font. If you need to react to programmatic font changes
+   * as well, use the notify::font-name signal.
    *
    * Since: 2.4
    */